jade.mtp
Interface InChannel

All Known Subinterfaces:
MTP

public interface InChannel

This interface is the receiver's view of an MTP.


Inner Class Summary
static interface InChannel.Dispatcher
          Callback interface to be notified of message arrivals over this Message Transport Protocol.
 
Method Summary
 TransportAddress activate(InChannel.Dispatcher disp)
          Activates an MTP handler for incoming messages on a default address.
 void activate(InChannel.Dispatcher disp, TransportAddress ta)
          Activates an MTP handler for incoming messages on a specific address.
 void deactivate()
          Deactivates all the MTP handlers.
 void deactivate(TransportAddress ta)
          Deactivates the MTP handler listening at a given transport address.
 

Method Detail

activate

public TransportAddress activate(InChannel.Dispatcher disp)
                          throws MTPException
Activates an MTP handler for incoming messages on a default address.
Returns:
A TransportAddress, corresponding to the chosen default address.
Throws:
MTPException - Thrown if some MTP initialization error occurs.

activate

public void activate(InChannel.Dispatcher disp,
                     TransportAddress ta)
              throws MTPException
Activates an MTP handler for incoming messages on a specific address.
Parameters:
ta - A TransportAddress object, representing the transport address to listen to.
Throws:
MTPException - Thrown if some MTP initialization error occurs.

deactivate

public void deactivate(TransportAddress ta)
                throws MTPException
Deactivates the MTP handler listening at a given transport address.
Parameters:
ta - The TransportAddress object the handle to close is listening to.
Throws:
MTPException - Thrown if some MTP cleanup error occurs.

deactivate

public void deactivate()
                throws MTPException
Deactivates all the MTP handlers.
Throws:
MTPException - Thrown if some MTP cleanup error occurs.